◀ Prev · Parts · Full · Next ▶

• Vordefinierte Annotationstypen

• Definition eigener Annotationen

• Verwendung eigener Annotationen

• Auswertung von Annotationen

• Annotation von Paketen

• Weblinks

In Java SE 5.0 stehen sieben vordefinierte Annotationstypen zur Verfügung, die in den Paketen (Package) java.lang oder java.lang.annotation liegen. Sie werden alle (im Gegensatz zu den meisten Annotationen) vom Compiler ausgewertet. Weitere können von Programmierern erstellt werden.

| Annotation | Beschreibung |

|---|---|

| Im Paket java.lang befinden sich Annotationen. | Im Paket java.lang befinden sich Annotationen. |

| @Deprecated | Hiermit können Klassen, Attribute oder Methoden gekennzeichnet werden, die nicht mehr verwendet werden sollen. Der Compiler gibt dann eine Warnung aus, wenn ein so gekennzeichnetes Element verwendet wird. Es empfiehlt sich zusätzlich, einen Javadoc -Kommentar anzubringen, der aufzeigt, wie das entsprechende Element ersetzt werden soll. Das folgende Beispiel zeigt dies: /** * @deprecated Die Klasse A wurde mit Version 10.3 durch die Klasse ANeu ersetzt. */ @Deprecated public class A {} |

| @Override | Mit diesem Typ kann eine Methode gekennzeichnet werden, die die Methode ihrer Oberklasse überschreibt. Der Compiler stellt dann sicher, dass die Oberklasse diese Methode enthält und gibt einen Fehler aus, wenn dies nicht der Fall ist. Beispiel: public class A { public void eineMethode () {} } public class B extends A { @Override public void eineMethode () {} } |

| @SuppressWarnings | Bei der Verwendung dieses Annotationstyps unterdrückt der Compiler bestimmte Warnungen. Der Annotation wird dazu ein Array mit Strings übergeben, die die zu unterdrückenden Warnungen enthalten. Im folgenden Beispiel wird der Compiler angewiesen, die deprecated -Warnung für die Klasse EineDeprecatedKlasse zu unterdrücken: public class A { @SuppressWarnings ({ "deprecation" }) public void eineMethode () { EineDeprecatedKlasse b = new EineDeprecatedKlasse (); } } |

| @SafeVarargs | Mit dieser Annotation wird versichert, dass die Varargs-Parameter mit Generics nicht zur Laufzeit mit einem unpassenden Generics-Typ ersetzt werden. Beim Aufruf der Methode bzw. des Konstruktors wird dann keine Warnung angezeigt. Die Annotation wurde mit Java 7 eingeführt. Bis Java 6 konnte man beim Aufruf mit einer @SuppressWarnings-Annotation das Vertrauen in den aufgerufenen Code dokumentieren, ab Java 7 kann die Methode sich selbst als vertrauenswürdig deklarieren. |

| Im Paket java.lang.annotation – diese werden nur für die Definition von Annotationen gebraucht. | Im Paket java.lang.annotation – diese werden nur für die Definition von Annotationen gebraucht. |

| @Documented | Dieser Annotationstyp wird als Meta-Annotation verwendet: Eine Annotation dieses Typs legt für einen neu erstellten Annotationstyp fest, dass er von Javadoc bei der Erzeugung der Dokumentation berücksichtigt wird. |

| @Inherited | Dieser Annotationstyp wird bei der Programmierung einer Annotation angewandt. Damit kann festgelegt werden, dass diese zusammen mit einer Klasse vererbt wird. Wird diese Annotation dann beispielsweise bei einer bestimmten Klasse angewendet, so gilt diese auch für alle Klassen, die von dieser erben. |

| @Retention | Dieser Typ wird bei der Programmierung einer Annotation angewandt. Sie gibt an, wann auf sie selbst zugegriffen werden kann. Es gibt drei mögliche Werte für eine Annotation dieses Typs, die in der Enumeration java.lang.annotation.RetentionPolicy aufgeführt sind: CLASS Die Annotation wird mit der Klasse kompiliert und ist damit in der .class-Datei vorhanden. Allerdings kann sie nicht während der Laufzeit einer Anwendung ausgelesen werden. Dies ist der Standardwert. RUNTIME Die Annotation kann während der Laufzeit einer Anwendung mittels des Reflection-Mechanismus ausgelesen werden. SOURCE Die Annotation wird vor dem Kompilieren aus dem Quelltext entfernt. Entsprechend steht sie zur Laufzeit eines Programms nicht zur Verfügung. |

| @Target | Dieser Annotationstyp wird bei der Programmierung einer Annotation angewandt. Damit wird festgelegt, auf welche Elemente eines Programms sie angewendet werden darf. Die möglichen Werte für eine Annotation dieses Typs sind in der Enumeration java.lang.annotation.ElementType aufgeführt. TYPE Die Annotation kann nur auf Klassen, Interfaces oder Enumerations angewandt werden. FIELD Die Annotation kann nur auf Felder angewandt werden. METHOD Die Annotation kann nur auf Methoden angewandt werden. Konstruktoren sind dabei ausgeschlossen. PARAMETER Die Annotation kann nur auf Parameter von Methoden und Konstruktoren angewandt werden. CONSTRUCTOR Die Annotation kann nur auf Konstruktoren angewandt werden. LOCAL_VARIABLE Die Annotation kann nur auf lokale Variablen angewandt werden. ANNOTATION_TYPE Die Annotation kann nur auf Annotationen angewandt werden. PACKAGE Die Annotation kann nur auf Paketen angewandt werden. |

◀ Prev · Parts · Full · Next ▶